- THE ALPHA JOYSTICK" 

For the TRS-80 Model I Microcomputer 
INSTRUCTIONS 



INSTALLATION 

If you have an Expansion Interface, plug the connector module of your Alpha Joystick into the 
"expansion bus port" (left side panel, to the right of the parallel printer port)* For systems 
without an Expansion Interface, plug onto the 40 pin bus on the left rear of the keyboard* 

Make certain that the top of the connector module is facing upwards. Always plug and uplug the 
Alpha Joystick with computer power turned off. 

Insert the connector by holding the module sides. Then push firmly until you can feel that the 
connector is properly seated. 

To unplug, hold the module by it's sides and gently wriggle side-to-side while pulling. 

JOYSTICK GAMES 

There is a two position mode switch on the joystick connector module. 
Use the "5" position for all games produced by BIG FIVE SOFTWARE. 

Use the "4" position for all other games, including those by ADVENTURE INTERNATIONAL, 
CORNSOFT GROUP, ALPHA PRODUCTS, etc. 

Most joystick software includes an explaination of how the joystick interacts with that 
particular game. Plugging-in the joystick and running the software is the simplest way to learn 
how the joystick functions in a particular game. 

You can begin playing games immediately. The following information is intended for those wishing 
to write or modify programs or who desire an understanding of how the joystick functions. 

DEMONSTRATION PROGRAM 

The last page of these insl ructions contains a listing of a graphics creation program for 
joystick entitled "Alpha Joystick Demo Program". This program can be typed-in and run in BASIC. 
Use your Alpha Joystick to create graphics the fun and easy way. Place mode switch in the "5" 
position. 



TESTING THE ALPHA JOYSTICK i 

Type in this short BASIC program! 5 <ij> 9 

10 A=255-INP<0> (we will explain the 255 later) 4 3= A ^ 8 

20 PRINT @tf,A cf J! \j 

30 GOTO 10 6 <J> 10 

2 

When this program is run, the value should be displayed on the top left of your screen. This 
indicates that the joystick is not activated and is the same as if there were no joystick 
connected to the computer. 

Now try the eight different joystick directions. They should correspond with the values on the 
diagram above. Notice that each direction has a different value and that the diagonals are the sum 
of the right angle components. For example, UP is 1,1 J:FT is 4, therefore, UP & LEFT is 1+4 * 5« 

The output of the FIRE button depends on which po^ 1 1 ion the selector switch on the connector 
module is in. The switch selects either the old 4 bit n nie or the new 5 bit mode. 

With the switch in the "4" position, FIRE has a val</ of 3, which is made by combining the UP 
(value = 1) and DOWN (value = 2). UP and DOWN are u. jtually exclusive of each other (they can not 
be activated simultaneously). This allows the use of i he UP-DOWN combination (value = 3) as the 
firt code. 
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With the selector switch in the "5" position, pressing the FIRE button results in a value of 16. 
In the "5" position, the joystick uses 5 bits instead of 4. The 5 bit mode has certain advantages 
as explained under "Mode Selection Switch". 

The output of the joystick is always the combination of all activated functions. Thus if the 
stick were pushed left and the fire button pressed simultaneously, a value of 20 (16 for fire ♦ 4 
for left) would be displayed, assuming that the mode switch was set for "5 M . 

UNDERSTANDING THE ALPHA JOYSTICK 

The ALPHA JOYSTICK is a "ported" device, like the cassette recorder, It uses a port address 
(port 16), and therefore does not use any memory space. To communicate with the computer the BASIC 
INR0) (INput Port zero) statement is used. Each time a program executes an INP(0), the computer 
"reads" the joystick and returns a number corresponding to the joystick's present state. This 
number should be stored in a variable so the program can subsequently look at it and take the 
proper action. 

A=255-INP(0) is the general way to read the Alpha Joystick. Here is a simple program that will 
familiarize you with joystick operations'. 

10 DEFINT A This is just to speed up the program execution. 

20 A=255-INP(0) This puts the joystick status in variable A. 

30 IF A=l THEN PRINT M UP" 

40 IF A=2 THEN PRINT"DOWN" 

50 IF A=4 THEN PRINT"LEFT M 

60 IF A=8 THEN PRINT"RIGHT" 

70 IF A=3 THEN PRINTTIRE" If selector switch is in the "4" position. 

80 IF A*16 THEN PRINT'TIRE" If selector switch is in the M 5" position. 

90 GOTO 20 

You can expand this short program to read the diagonals as well. For example, add this line * IF 
A=5 THEN PRINT"UP AND LEFT". The program will now recognize the "UP & LEFT" direction. 

You may have wondered why we have been using A=255-INP<0) rather than just A=INP<0>. The reason 
is convenience. Type: PRINT INP(0) and press enter. The computer returns 255. Because the TRS-80 
data lines are normally high, (pulled up) the computer returns the maximum value possible for an 
INP statement (255), even if nothing is connected to the computer. While there is nothing wrong 
with this, it is much simpler to work with small numbers like 1,2,4,8 rather than 254, 253, 251, 
247 which are the actual values returned by the INP(0) statement. So we "invert" the readings. Now 
an idle joystick reads 0, and any activation of direction or FIRE results in an easily 
recognizable number such as 2 for DOWN. Summery table? 

DIRECTION A=255-INP<0) A=INP(0) BIT USED BINARY WEIGHT 

UP 1 254 t 1 

DOWN 2 243 1 2 

LEFT 4 251 2 4 

RIGHT 8 247 3 8 

FIRE (Mode 4) 3 252 t & 1 3 

FIRE (Mode 5) 16 239 4 16 

Remember, the diagonal directions as well as the FIRE + direction combinations are obtained by 
adding the corresponding values of A when using A=255=INP(0). 
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MODE SELECTOR SWITCH 

Beginning in October , 1981, a new version of the Alpha Joystick replaced the original 
"Stick-80". The new Joystick has an added feature. A two position mode selector switch on the 
joystick interface allows either 4 bit or 5 bit operation to be selected. The 5 bit operation is 
new and has some programming advantages while 4 bit operation preserves compatibility with the 
original joystic-t and the many existing games available in joystick version. 

In the 4 bit mode, the joystick uses the lower 4 of the 8 bits available on the computer's data 
bus. The 4 directions} UP, DOWN, LEFT and RIGHT, correspond with bits 0,1,2 and 3 respectively. In 
this 4 bit mode, the fire function is derived by combining the UP and DOWN bits, and 1. 

The new 5 bit mode has the advantage of using a seperate bit for the FIRE function. The 4 
directions still use bits 0,1,2 and 3, however now the FIRE function has a bit of it's own, bit 5. 
In this mode there is no ambiguity between UP/DOWN control and FIRE. This means that programs can 
be written where directional changes can be made while the fire button is activated. Another 
advantage is that programming is simplified as no "masking" scheme is required tc seperate the 
UP/DOWN fuction from the FIRE funtion. Any programs that you write or modify, should take 
advantage of t lis new 5 bit mode. 

CONVERTING BASIC PROGRAMS 

Although many of the best action games are available in joystick version, you may wish to 
convert some non-joystick BASIC programs for joystick control. Provided that the game is written 
in BASIC, this is a fairly simple matter. 

The type of program that is a good candidate for joystick conversion is one that uses character 
keys for directional control. Usually the arrow keys or the "<" and ">" keys govern direction and 
the space bar commands FIRE. In most cases, the program will contain a routine or subroutine using 
the BASIC "INKEY*" function for keyboard input. An INKEY* loop repeatedly checks the keyboard for 
any valid keystroke, and if it detects one, branches to the appropriate subroutine, The subroutine 
then executes the proper response for that keystroke and when done, returns control once again to 
the INKEY* loop. Usually it is only neccessary to modify this INKEY* loop in order to convert to 
joystick control. Here is an example of a typical keyboard input routine* 

1000 A* = INKEY* : IF A$=" THEN 1000 

1010 IF A*="< M THEN GOSUB XXXX 
1020 IF A*= M >" THEN GOSUB YYYY 

The joystick version would be? 

1000 A=255-INP(0) J IF A=0 THEN 1000 

1010 IF A=4 THEN GOSUB XXXX 
1020 IF A=8 THEN GOSUB YYYY 

For maximum execution speed, delete the old input scheme. In addition, use the BASIC "DEFINT"* 
(DEFme as an INTeger) function on the variable used. In this case for example, place a "DEFINT A" 
statement in the initialization portion of the program. 

MACHINE LANGUAGE GAMES 

The fastest action games are written in machine language. Modification of these games requires 
some knowledge of machine language however, the principle is the same as in a BASIC program. The 
control input routine should be modified to read Port (where the joystick resides) instead of 
scanning the keyboard memory locations, 
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EXPANSION 

If you have other devices that also plug onto the 40 pin bus such as a modem or screen printer, 
you may wish to utilize one of our EXPANDABUS series of bus expansion cables. EXPANDABUS allows 
connection of multiple devices on the TRS-80 bus, and is available in x2, x3, x4, and x5 
configurations. 

Your ALPHA JOYSTICK can remain connected to the TRS-80 bus at all times as it draws no power and 
will not interfere with any other equipment connected to your system. 

LIMITED WARRANTY 

The manufacturer warrants that the item furnished hereunder, is free from defects in material 
and workmanship to perform to published specifications for a period of ninety (90) days from the 
date of original purchase. Under no circumstances will manufacturer be liable for special or 
consequential damages as a result of any alledged breach of this warranty provision. The liability 
of manufacturer hereunder shall be limited to replacing or repairing, at it's option, any 
defective units that are returned F.O.B. manufacturer's plant. Units or parts which have been 
subjected to abuse, misuse, accident, alteration, neglect, or unauthorized repair are not covered 
by warranty. Opening either the joystick or the interface module voids warranty. 



ALPHA JOYSTICK DEMO PROGRAM 

10 CLSJPRINT M KJHA JOYSTICK DEHO PROGRAM": PRINT: PRINT 

12 PRINT" > FIRE BUTTON TOGGLES BETWEEN ORAM AND ERASE hOOE" 

14 PRINT" > FOR A NEW SCREEN, PRESS FIRE WITH STICK LEFT" 

16 PRINT" > FOR A HKJ-REVIRSE EFFECT, PRESS FIRE WITH STICK RIGHT" 

28 CLEARH00:DEFINTA-Z:X=32:Y=24:Pi=STRING$(61,CHR$(19t)):S=l 

30 A*=STRING$(255,191)!B$=tEFT$<A$,3>iON ERROR GOT0190 

10 PRINT :PRINT:PRINT"SELECT SPEED J 1 (SLOW) TO 9 <fast)":print:print m speed ?" 

50 i*=owey*:if 1$="" then 58 else e=val(i$) 

60 print:print:print:d=(9-E)iio 

70 print" > for black backround, push stick up m 

75 print" > for white backroun), push stick down" 

80 a=255-dp (i)jif a=0 goto80 

90 ifa<>2 and a<>1 then goto80 

100 CLSJff A=2 THEN W=15PRINTA*AiAiA$B$;:P0KE16383,191 

110 a=255-inp(0):forz=0tod:nextjset(x,y)jset(x+l,y) 

120 ifa=20thengoto70aseifa=16mns=-s:f0rt=0to100:next 

130 ifs=1 then reset(x,y):reset(x+1,y) 

140 if a=24 gosub220 

150 if a=l then y=y-1 elseif a=2 ton y=y+1 aseif a=4 then x=x-2 

160 if a=8 ton x=x+2 aseif a=9 then x=x+2j y=y-1 elseif a=10 ton x=x+2j y=y+1 

170 if a=6 then x=x-2! y=y+1 aseif a=5 ton x=x-2! y=y-1 

180 reset(x,y):reset(x+i,y):gotoho 

190 IFX>127,X=126:V=127aSEIFX<0,XMI 

210 IFY>47,YH7aSEIFY<0,Y=0 

210 RESUME180 

221 FWX=n012ASlEP2:FWr=ITO47 

230 P=POINT(X,Y)JIFP=-l,RESET(X,Y)aSEIFP=0,SET(X,Y) 

240 NEXTJNEXTJRETURN 
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WHY 

TALKING 

ROBOT 

ATTACK 




ALL GAMES ■ 

16KLevel2. Mod 1 ♦ Mod 3 Cassette $15 95 
32k Level 2. Mod 1 + Mod 3 Diskette: $19.95 
lOS, discount tor 2 games. 15% 'or 3 or more 
Games may be played with or without joystick / 




SCARFMAN 



IS THE ALPHA JOYSTICK 
SUCH A SUCCESS ? 




TALKING 
ROBOT ATTACK 

INCREDIBLE! This amazing game actually TALKS 
without a speech synthesizer, through the cassette 
AUX plug. 

You are armed with just a hand held laser in a 
remote section ot the space station you encounter 
armed robots some march towards you some wait 
around corners Watch out, the walls are electrified 
Zap as many robots as you dare Detore escaping 
into a new section where more robots await you 
The struggle continues With Joystick action and 
VOICE OUTPUT, this game will amaze you 






SCARFMAN 

THE LATEST ARCADE CRAZE now runs on your 

TRS-80 

It's eat or be eaten You control Scarfman around 

the maze gobbing up everything in your path You 

attempt to eat it all before the monsters devou' you 

Difficulty increases as game progresses Excellent 

high speed machine language action game From 

The Cornsoft Group With sound 

CAUTION: Played with the Alpha Joystick. Scartman 

may become addictive 




SUPER NOVA 



Asteruio:. "oat omu nusiy a'ounc we 
sneer Vun must destroy lie asteroids 
Detore ine> destn . *ou' .Big asteroids 
: real nlu lillle ones i vou' ship will 
respond 10 thrust rotate nyperspace 
and Me Walcn jui 'or thai saucei with 
the :dsei As reviewed in May 1981 By'e 
'.' I ;.:.• • e 



GALAXY INVASION 



lie sojiii! o' - ne ki«ur is caning yiiu 1 
m»,ideis nave bee° spotted warping 
towa'd Ea'th Vou shift ughl and lelt as 
you lire your lasers A lew Diea* torm 
alion and tiy straight al yon' Vou plate 
your linger on the lue button knowing 

that 'his shot must uonnaci 1 With sound 
eiteits 1 



ATTACK FORCf 



As you' snip appea": on 'ne bottom 01 
Ihe ina/e eigh' alien ships appear on l'ir 
lop an Hayenng directly at i/OU 1 'Oil 
move :oward mem and lite missiles Bui 

'he more aliens you destroy Ihe taste' 

!he leniairnng ones become II .-' 

too goon you must endure the Hag 
ship With sound ellecls 1 



COSMIC FIGHTER 



'on' .hip tomes "ml o' hyper Space 
nniter i lonvoy ol aliens 'on destroy 
eveiy one Bui another sel appea 
1 'it- st- seem more intelligent you 
eliminate ihem too vom 'uei xunp y is 
diminishing you must destiny Iwu inoie 
.els lietoie you i an «ii« k Ihe space 
station i . now on yum .. ai net With 
sound 1 



METEOR MISSION W 



Iflul 



astronaut . . ''....• 

maneuver II lout) • tslen ids % 

meteors ican you get bai > lo the >pai e 
station'] lue lasers lo desti , il 
asteroids but watch out 'heie outd tie 
an titer » I AliSHlf ufkmg Im ludes 
sound elle I 



THE ALPHA JOYSTICK: 
REAL ARCADE ACTION 

DFeatures the famous atari JOYSTICK 
Q Works with any level II or disk system Model l 
DPlugs direct'y into KB or E/l (next to printer porti 
QCompatibie with any other TRS-80 accessories 
QSavei. your keyboard 

□ un to experiment in BASIC Simply use A = INP(O) 
to read the |oystick 
QFully assembled ready to plug in and use. 

Price includes Atari Joystick + Alpha Interface ♦ 
instructions + demo program The Alpha Joystick 
is backed by an unconditional money back 
guarantee If you are not delighted with it. return it 
within 14 days to r a prompt and courteous refund 





Toll Free 
Order Line 

(800) 
221-0916 



AOO t ISO Pf | ORDER FOR SHIPPING AND HANDLING 

All ORDERS SHIPPED FIRST CLASS MAU 

WE ACCEPT VISA MASTER CHAHGF CHECKS MO. 

COD ADDS? 00 EXTRA ^^ 

QUANTITY DISCOUNTS AVAILABLE 

N y RESIDENT ADO SALES TAX 



jm 
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85-71 79th Street. Woodhaven NY 11421 



(212)296 5916 



